Help:Notifications
This is an information page. It is not an encyclopedic article, nor one of Wikipedia's policies or guidelines; rather, its purpose is to explain certain aspects of Wikipedia's norms, customs, technicalities, or practices. It may reflect differing levels of consensus and vetting. |
Developer(s) | Wikimedia Foundation |
---|---|
Type | Notification system |
Website | Notifications @ MediaWiki.org |
Notifications (commonly called pinging, formerly known as Echo) is a system designed to inform users about new activity on Wikipedia in a unified way. It provides notifications to users for a number of events related to their account, including new talk page messages, edit reverts, mentions or links. It is intended to augment the Watchlist, by highlighting key user interactions.
Notifications are displayed to the right of the username and user talk links in the top link bar of the page for logged-in users, displaying two icons, each with a number representing the number of recent notifications. Email notifications can also be set up for some or all types of notification in Preferences.
You can "mention" a user called Example by making an edit with a link to their user page (writing [[User:Example]], {{u|Example}}
, {{User|Example}}
, {{User link|Example}}
, {{Ping|Example}}
, {{Yo|Example}}
, or {{Reply to|Example}}
) and signing the edit using four tildes (~~~~). The user "Example" will then get a notification saying where they were mentioned. This is sometimes called "pinging". See Help:Talk pages#Notifications for more information.
Before Notifications, the only notifications that the MediaWiki software provided were given through emailed notifications for changes to your watchlist, and an orange bar for changes to your user talk page. To learn more about Notifications, visit the project hub on MediaWiki.org.
Viewing notifications
Toolbar icons
-
Alert badge
-
Notice badge
Notifications are either alerts or notices depending on the importance of the message. When someone takes an action that affects you, colored badges will appear next to your username, in the top right corner of any page. These notifications include cross-wiki notifications. When there are no notifications, these badges are grey.
The first badge (red, "alerts") contains more important notification types: new messages on your talk page, mentions, etc. The second badge (blue, "notices") contains less important notifications: page links, messages on other talk pages, etc.
These badges will show the number of new notifications you've received. Clicking on the badges will display a "fly-out" listing the most recent notifications (see screenshot) and set the badge color to grey again. The number will stay different from zero until you mark-as-read all your notifications for this badge (especially for messages).
You can click on the notification of your choice to find out more about it (see description below). To see all notifications received, you can click on "All notifications" to go to the notifications archive.
Notification layout
The most common notification types are all designed with the same pattern:
- An icon floated on the left (on the right for right-to-left languages)
- A circle floated on the right:
- filled with blue if the notification is unread
- white and circled of grey when read
- Primary information: Notification title, in bold
- Secondary information: Notification details (optional)
- Details: at the bottom, with some useful information:
- always the user who performs the action (with a link to their userpage) and date in a relative format
- sometimes other information, like the targeted page
- if needed, a three-dots menu with some options
The whole notifications is a link, usually to a diff that is related to the action you are notified about.
Unread notifications may be marked as read without following the link, by clicking on the blue circle; similarly, notifications that are shown as read may be marked as unread (for example, if you want to return to it later) by clicking the grey circle. Unread notifications do not remain indefinitely - they are automatically removed after about 16 months.
Similar notifications or notifications from other wikis are grouped.
Special:Notifications page
To find all your recent notifications, click on "All notifications" in the fly-out to go to the notifications page. On that page, all notifications are displayed by date. Your most recent notifications are listed first on this archive page. On Wikimedia wikis, that page also regroups cross-wiki notifications.
Types of notifications
All types of notifications below can be seen on Wikimedia wikis. You can see them on the wiki where you are, on another wiki via cross-wiki notifications, or on the page Special:Notifications.
Some of these notifications are turned off by default or not available on the English Wikipedia. If you would like to enable any of these notifications (or disable them), you can do so in your preferences.
Special:DisplayNotificationsConfiguration lists all notification types available and how they are configured.
Messages on your talk page
Alerts—Received when a message is left on your user talk page.
- Primary information: Message title.
- Secondary information:
- in case of a new message: who left the message, and on which page. Links directly to the message.
- in case of multiple new messages or multiples replies, messages may be grouped ("six new messages on [that page]").
- Details: Link to the user page of the last user who left you a message for that group.
This notification replaces the orange bar that used to appear, but you can set up your preferences to have the orange bar.
Mentions
Alerts—Received when someone mentions you on a talk page.
- Primary information: Who mentioned you, where, and about what. Linked to the page you are mentioned in.
- Details: link to the user who mentioned you and the diff where you are mentioned.
To mention another editor and trigger this notification for them, you need to:
- Create a new comment; modifying an earlier comment does not work.
- Link to their username
- Sign your comment with
~~~
or~~~~
. Notifications will not be sent if your signature is embedded in a template, or has no link to your user page or user talk page. - Not alter any text outside your own comment.
- Not exceed 50 mentions.
Note:
- Notifications are only sent to registered users; notifying anonymous users (IPs) by mentioning their IP address is not possible.
- You cannot notify yourself.
Specific and additional technical details are at mw:Manual:Echo.
Mentions in edit summaries
Alerts—Received when someone links to your user page in an edit summary.
- Primary information: Who mentioned you, where, and the edit summary. Linked to the change in question.
- Details: link to the user who mentioned you.
To mention a user, just link to their user page, using the normal wikitext syntax: [[User:Username]]
. All the usual link styles work, like [[User:Username|some text]]
or [[User:Username|Username]]
. [[User:Username|]]
will work, but it will display User:Username
with a link to the user page on the History page. No more than 5 users can be mentioned in an edit summary. Mention templates don't work in edit summaries. There is no requirement that the edit itself creates a new comment, so this method can be used when you modify a comment.
To leave a link in the summary without notifying a user, prefix username with :
, like this: [[:User:Username]]
.
Successful mentions
Notices—Received when your mention has been sent to other user.
- Primary information: who you mentioned.
- Details: link to the page you mentioned the user on.
Failed mentions
Alerts—Received when your mention to other user was not sent.
- Primary information: who you tried to mention, and the reason the mention was not sent.
- Details: link to the page you tried to mention on.
These notifications are sent when:
- trying to mention an anonymous user or users that does not exist, or
- exceeding the limit of mentioned users in a single edit (currently 50).
Reverted edits
Alerts—Received when your edits are undone or rolled back.
- Primary information: Who reverted you, and where. Links to the diff.
- Details: link to the user who reverted you.
Email received
Alerts—Received when someone emailed you through the wiki.
- Primary information: Who emailed you. No link given for this information.
- Details: link to the user who sent you this email.
People can send you emails only if you have allowed this on your preferences.
User rights changes
Alerts—Received when your user rights change. Doesn't include if it's automatic, like when you become autoconfirmed or extended confirmed.
- Primary information: what has been changed, and by who. Links to Special:UserGroupRights page.
- Details: link to the user who changed your rights.
Failed login attempts
Alerts—Received when someone attempted and failed to log in to your account.
Multiple alerts are bundled into one for attempt from a new device/IP, but for a known device/IP, you get one alert for every 5 attempts. See the login notification documentation for more information.
Welcome
Notices—Received when you have just created your account.
- Primary information: Welcome!
- Details: link to a welcome page as defined on the wiki configuration (MediaWiki:Notification-welcome-link).
Milestone
Notices—Received when you reach certain edit count milestones.
The current milestones are powers of ten (1st, 10th, 100th, 1,000th, 10,000th, 100,000th, 1,000,000th and 10,000,000th edits).[1]
- Primary information: Which milestone you've reached, and which edit triggered the notification.
Thanks
Notices—Received when someone thanks you for your edit.
- Primary information: Who thanked you, where, and about what. Linked to the diff that you are thanked for.
- Details: link to the user who thanked you, and if it was on a Structured discussion board to the page.
Available by default, but it is possible to opt-out into Preferences.
You can thank someone from any History page, from a diff comparison, or in your watchlist. Remember that thanks are stored in a public log (Special:Log/thanks).
Links to articles you created
Notices—Received when a new link is made to a page you created.
- Primary information: The page that you created, and where it was linked from. Links to the page that has the new link.
- Details: link to "What links here" page for the targeted page.
You can mute these notifications for individual pages, either:
- from your preferences (see how to)
- via a given notification, by clicking on the three dots.
Page patrolled
Notices—Received when a page which you created is reviewed (or "patrolled") by a new page patroller.
- Primary information: Which page has been reviewed, and who reviewed it.
Connection to Wikidata
Notices—Received when your page is connected to Wikidata.
- Primary information: the name of the page that was connected.
- Details: link to the data item and, possibly, to a local help page.
Cross-wiki
Cross-wiki notifications are displayed on both panels, and regroup notifications from other Wikimedia Foundation hosted wikis. For example, while on the English Wikipedia, you can receive notifications from Commons, and these will be grouped together with notifications from other wikis like Wikivoyage. On Commons, the project-specific notifications would be ungrouped, and notifications from the English Wikipedia would be grouped with notifications from other wikis. Learn more about cross-wiki notifications.
OAuth
- OAuth development
- notifies developers of OAuth applications when the review status of the application has changed.
- OAuth admin
- notifies OAuth admins about new applications waiting for review.
Preferences and settings
Access to preferences
You can control what kinds of notifications you get (and how often) by updating your notifications preferences. To check your settings, click on "Preferences" in the fly-out (shown above) – or in the "All notifications" archive page. (You can also click on "preferences" in the top right of any page, then select the "Notifications" tab.)
Opt-in and opt-out
If you opt out of any type of notifications, then these notifications generated while you were opted-out are not generated for you and not stored in databases. Opt-in will not display them afterwards. The only notifications that may be displayed are the one that existed before the opt-out.
Notifications by email or on wiki
To turn notifications on or off for any category, simply check (or uncheck) the box next to it. You can enable (or disable) notifications on the web or by email for most categories. (Some notifications cannot be disabled, such as changes to your user rights or new talk page messages: these notifications are too important to be dismissed.) You can also control how often to receive email notifications, from single emails for each event to daily or weekly digests. When you're done, be sure to click the "Save" button at the bottom of the page to update your preferences.
Muting users
You can mute on-site notifications from individual users, by typing their username into the box at the bottom of the notifications preferences. When you start typing, the usernames will autocomplete. Users without JavaScript should type one username per line, without any wikitext or prefix.
You will still receive notifications if a muted user writes or participates on your user talk page, or reviews a page you have created. Watchlist behavior and emails are not affected by the mute list.
The muted user will still receive a successful mention notification, if they've enabled that preference. A user's mute list is private from all other users on the wiki, including administrators or any other functionary.
Muting pages
Muting pages is possible for "page linked" notifications.
You can mute "page linked" notifications for a page by typing the page name into the box at the bottom of the notifications preferences.
When you start typing, the page titles will autocomplete.
Users without JavaScript should type one page title per line, without any wikitext or prefix.
Community blacklisting
There is a site-wide list of accounts that cannot trigger notifications at MediaWiki:Echo-blacklist, which can be overridden by users at Special:MyPage/Echo-whitelist.
Known bugs
There are a number of bugs currently known with the notifications system:
- Failure to spot signatures. In some cases (usually when changing another, recent, comment with a signature) the parser does not realise that a user has made a new signed comment, and so does not trigger a notification. The technical requirements for notifications to work are described in mw:Help:Echo § Technical details.
- Confusing section titles. On pages with complicated markup, or after edit conflicts, the notification will sometimes give the wrong section heading for a message.
- Transclusion. Because a notification is generated whenever a page is linked to, accidental transclusion of other pages can cause a sudden flurry of unintentional notifications through links on the transcluded page.
For all open Notifications related bugs, see the list on Phabricator.
See also
- Help:Fixing failed pings
- {{Interwiki talkback}} – a "you have new messages" notice to put on other users' talk pages for interwiki purposes
- {{You've got mail}} – notifies of an offsite e-mail
- {{Reply to}} – aka Ping
- Wikipedia:Software notices
- "Peach bar of doom" – a banner notifying unregistered users of new talk page messages